home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
sbrain.zip
/
SBRAIN.DOC
< prev
next >
Wrap
Text File
|
1993-01-08
|
20KB
|
493 lines
1/8/93
THE BRAINEX SHOP MASTER
A Credit Card Orders/Subcription Door
(C) Copyright 1992 by Stanley Sheff
Support BBS: The Brainex System
(310) 275-2344
(310) 273-5234
> This door requires the Brainex Door Manager. If you have not done so,
> please install The Door Manager BEFORE you attempt to setup this door.
> Be sure that your BRAINEX.DAT is dated on or after the date of
> SBRAIN.EXE.
Welcome to the Shop Master. This door allows your callers to upgrade
their subscriptions and levels or order products using a VISA, MASTER CARD,
AMERICAN EXPRESS, DINER'S CLUB, CARTE BLANCHE or DISCOVER CARD
Shop Master creates it's own online product catalog, which may
be downloaded or viewed online.
* If you are a Teleflora Creditline user, Shop Master will work
* with TelePC to verify user's orders online, or after they log off
* the BBS. Amounts charged can be directly deposited into your
* checking account! For more information, read TELEPC.DOC.
Shop Master will write an invoice file with all the information needed
to process a credit card order. Shop Master will check for a valid
credit card number, but you will be required to verify the account
by phone.
GAP & PCBoard BBS: The door will automatically upgrade the user's
level and subscription date online.
PCBoard needs to write DOOR.SYS and USERS.SYS when running the door.
Shop Master updates DOOR.SYS for GAP or any DOOR.SYS type BBS.
USERS.SYS is updated for PCBoard.
=====================================================================
If you have registered ORDER BRAIN before December 10, 1992, you can
switch to The Shop Master at NO COST. First, you will need to convert
your ORDER.DAT file to CATALOG.DAT. Run the included CONVERT.EXE.
Next, call the Brainex System, and post your BBS Name and Registration
number in private mail to the SYSOP. You will be issued a Shop Master
registration number. If you register ORDER after December 10, 1992,
you may apply your $25 Order Brain registration fee toward the purchase
of The Shop Master. This makes the cost to switch only $20.
=====================================================================
The Shop Master Files
---------------------
SBRAIN.EXE <------------------ The Shop Master Program
SBRAIN.DOC <------------------ Sysop's Information
SBRAIN.HLP <------------------ Online Door Help
CONVERT.EXE <------------------ Converts ORDER.DAT to CATALOG.DAT
REGISTER.DOC <------------------ Registration information
PRODUCTS.DOC <------------------ Latest Brainex Products!
TELEPC.DOC <------------------ CreditLine Information (Registered Version)
INVOICE.TXT <------------------ Sysop's Invoice Template
RECEIPT.TXT <------------------ Customer's Receipt Template
DEALS <------------------ ASCII Special Deals
DEALSG <------------------ ANSI Special Deals
HAGGLE <------------------ Haggle Data File
INFO <------------------ ASCII General Help File
INFOG <------------------ ANSI General Help FIle
LEVEL <------------------ ASCII Invalid Level Notice
LEVELG <------------------ ANSI Invalid Level Notice
MENU <------------------ ASCII Order Options/Prices
MENUG <------------------ ANSI Order Options/Prices
NOTICE <------------------ ASCII Warning Notice
NOTICEG <------------------ ANSI Warning Notice
SUB <------------------ ASCII Subscription Thank You File
SUBG <------------------ ANSI Subscription Thank You File
THANKS <------------------ ASCII Thank You (shown after an order)
THANKSG <------------------ ANSI Thank You (shown after an order)
FILE_ID.DIZ <------------------ Short Door Description
SETUP.BAT <------------------ Door Installer Batch File
NOTE-> If you have edited an ANSI info file and see a "MORE - Yes, No,..."
prompt, you can either save the file with a longer line length (255)
or use a text editor to insert a { character on the first line
of the file. This disables the "MORE - Yes, No,..." prompt when
the file is shown by the door.
All of these files should be in this ZIP, if they are not, don't
take a chance! Call The Brainex System and get a good copy or view the
file on a few local boards to see if you can find a complete copy.
To install, unzip these files into a work directory, then type:
SETUP
A BRAINEX\SBRAIN directory will be created.
SBRAIN.EXE will be copied to the BRAINEX directory, the rest of the
files to the BRAINEX\SBRAIN directory.
You will then be taken to the Door Manager Door Install area.
Shop Master Setup Questions/Options:
Please enter your Shop Master Registration number, or 0 if unregistered.
> When registered, Shop Master will save user's orderig information
> to an ascii file you specify. Unregistered version will not save
> to disk, but will otherwise function normally.
Please enter the DRIVE\DIRECTORY\NAME of the text to write information
about orders placed by callers. (Do NOT include a file extension.)
> This is the name of the file that will hold all the information
> about a user's order. If the order was processed successfully,
> an extension of YES will be used, if the order did not pass
> the verification process, an extension of NO will be used. If
> you entered C:\CREDIT\ORDER as the file name, a good order would
> be stored as C:\CREDIT\ORDER.YES.
Enter the minimum caller access level required to use this door.
> Callers with an access level below this will not be able to
> access the door. They will be shown the LEVEL file.
Enter the level and above that will bypass this door?
> This level is usually used for the sysop who has setup Shop Master
> as a "logon" door, and does not wish to see the door during logon.
Enter the Credit Card types you will allow:
VISA=VS, MASTERCARD=MC, AMERICAN EXPRRSS=AM, DISCOVER=DS
DINER'S CLUB=DC, CARTE BLANCHE=CB, JCB=JB
When a user buys a BBS subscription, when should the
user's additional subscription days begin?
TODAY=New subscription period begins day of the order.
EXPIRE=Add days after subscription expiration date.
> If a user buys a BBS subscription, the new time period can begin
> after the old on expires, or can begin on the day they order.
> Example: A user has 10 days left on a previous subscription, buys
> an additional 30 day subscription. If you set to TODAY, the user
> will have a total of 30 days remaining, if you set to expire,
> the user will have 30 new days added to the old 10, giving
> them a total of 40 days.
> Note: PCBoard adds additional days to the current expiration
> date, so this option will not matter.
Should Shop Master be allowed to lower a subscription level?
YES=New user level can be lower than previous level
NO=Only change if new level is above current level
Enter the colors for displayed text (B=Bright, BBLUE is Bright Blue)
RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE
BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE
> This is used for catlog text searches.
Enter the colors for search hit text (text found during searches)
RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE
BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE
Enter your Sales Tax Rate Percentage or NONE
> Example: 8.25
Enter your two letter State Abbreviation
> Use two letters only, do NOT add a period (CA.)
> Caller's from this state will be taxed.
Enter full State Name for tax
> Caller's from this state will be taxed.
Enter the DRIVE\DIRECTORY of Your TelePC software or }NONE
> This program will process your merchant account orders
> online without the need for a terminal! See the enclosed TELEPC.DOC
> for information on how to obtain this software package!
Shop Master can process orders in one of two modes:
ONLINE-Uses second comport/modem while caller is online.
* If you do not use TelePC, select ONLINE
OFFLINE-Processes the order after caller logs off the BBS.
Select ONLINE or OFFLINE.
You may attach a TEXT FILE to user's receipts
Please enter DRIVE\DIRECTORY\FILENAME.EXT or NONE.
> This should be an ASCII text file.
Enter your invoice start number. Invoices numbers will begin with this.
> Any Number
Enter the DRIVE\DIRECTORY where download files are located.
> If you want users to be able to download files using Shop Master,
> enter the directory location of the files. Enter NONE to disable
> this option.
Enter the DRIVE\DIRECTORY\FILENAME.EXT to your Files List (FILES.BBS)
> Complete path and filename of file description text file.
> This file uses a FILES.BBS type format. Each file should use the
> following column format:
FILENAME SIZE DATE DESCRIPTION
1<------------->13 14<------->21 24<-------->31 34<---------->78
Examples:
ALADDIN.ZIP 89867 08/25/92 Aladdin's Magic Lamp Text Adventure
SBRAIN.ZIP 123467 12/01/92 Shop Master - Credit Card Order Door
Would you like to allow callers to log off the BBS after downloads?
> YES or NO
Enter the Maximum Number of Minutes users may stay in the Shop Master.
> Any number from 1 to 32767
---------------------------------------------------------------------
CATALOG.DAT file
================
Use an ASCII text editor to create your CATALOG.DAT file. This is
used by Shop Master to obtain specific information about the items
you will offer to your users.
CATALOG.DAT options:
ITEM - Brief Product Description
INFOFILE - DRIVE\DIRECTORY\FILENAME.EXT of Descriptive Text File
PRICE - Price in Dollars and Cents format 00.00 (Don't use a $)
TAX - If the caller is not from out of state, tax will be
added if this option is TAX=YES
SHIPPING - Shipping Fee in Dollars and Cents format 00.00 (Don't use a $)
If using Shop Master for BBS subscriptions, you can use:
LEVEL - Upgraded user level. If the user's level is below this
level, the user will be upgraded to the indicated level.
DAYS - Addtional Days added to user subscription period
End each item section with three dashes ---
Sample CATALOG.DAT file format:
ITEM=One Month BBS Subscription
INFOFILE=C:\BRAINEX\SBRAIN\INFO.TXT
PRICE=15.00
LEVEL=90
DAYS=30
---
ITEM=Night Owl CD-ROM Volume 7
INFOFILE=C:\BRAINEX\SBRAIN\CDROM.TXT
PRICE=30.00
TAX=YES
SHIPPING=2.00
---
ITEM=Printed BBS Manual
PRICE=2.00
---
You must include an item and a price. Other selections are optional.
INVOICE.TXT (Sysops Invoice Record)
RECEIPT.TXT (Customer's Receipt)
=========================
These are text file templates that use special replacable commands:
@INVOICE @CARDINFO
@DATE @ADDRESS
@TIME @HOMEPHONE
@VERIFICATION @BBSNAME
@USERNAME @BBSPHONE
@TAX @SHIP
@TOTAL @DISC
After an order, Shop Master replaces these "@" commands with the
actual user information, then writes a file to disk as the FILENAME
you specified above (order information file).
RECEIPT.TXT may be read or downloaded by the user. Be sure to edit
in your BBS information!
Please EDIT these file as you wish using any ascii text editor.
Be sure your editor does not use CONTROL Z to terminate a line.
The replacable parameters should be the LAST ITEM on a line
(@DATE, @TIME, etc.). These files should be located in BRAINEX\SBRAIN.
DEALS.TXT
=========
If you wish to offer any special deals, create this file and place
it in your BRAINEX\SBRAIN directory. Optional ANSI version should
be named DEALSG.TXT
HAGGLE
======
If present in the BRAINEX\SBRAIN directory, Shop Master will allow
you to offer a discount. Users can select the [H]aggle option before
they place an order, and try to haggle a better price! You can select
the name of the "haggler", the maximum discount percentage rate offered,
and the a choice of remarks made by the haggler to the user.
Sample HAGGLE file:
------------------------------------------------
MAXIMUM HAGGLE DISCOUNT=10
HAGGLER NAME=Crazy Murray
You think I'm made of money?
You'll have to do better than that, my friend!
That's not an offer, that's a joke!
Let's get real, ok?
Talk to me when you get serious...
I might be crazy, but I'm not THAT crazy!
Talk some turkey!
Hmmm... That's an interesting offer, but no deal!
-------------------------------------------------
The maximum haggle discount is a percentage, so the above example
would allow a maximum discount of 10% off the total purchase price.
The discount will be indicated in receipts and invoices with the @DISC
parameter.
You may add as many haggle remarks as you like, just put each on
a seperate line as shown above.
Remove the HAGGLE file from the BRAINEX\SBRAIN directory to
disable haggling.
CATALOG
=======
The first time you run Shop Master, it will create two catalog files
in the BRAINEX\SBRAIN directory.
CATALOG.STD - (Standard Catalog) Item, Price, Shipping
CATALOG.DLX - (Deluxe Catalog) Item, Price, Shipping,
Detailed Item Information
(Derived from the text you supplied in INFOFILE=files)
Users may View, Search, Order from the Catalog, or Download the catalog.
DOWNLOADS REQUIRE DSZ or GSZ
============================
Place DSZ.COM or DSZ.EXE in the path. If you have an unregistered DSZ,
Y-Modem G protocol will NOT function. If you wish to use GSZ,
simply rename GSZ.EXE to DSZ.EXE, or you can edit the batch files
that call GSZ. They are located in the BRAINEX directory, and
are named: EXTSZ.BAT, EXTS1.BAT, etc. You should add an environment
variable to set the dsz log file name, and if using gsz, the window
size. If the DSZLOG varible is not set, NO download logs will be
written. See the sample batch files below.
RUNNING SHOP MASTER
===================
Once you have created your CATALOG.DAT, you must then create a a batch
file to call the door. A batch file for a GAP BBS might look like this:
@ECHO OFF
SET GSZWINDOW=23
SET DSZLOG=LOG1
SBRAIN
Multinode BBSes use the NODE= command. Example:
@ECHO OFF
SET GSZWINDOW=23
SET DSZLOG=LOG2
SBRAIN NODE=2
========================================================================
TELEPC (Registered Version Only)
Telepc-b.exe must be configured and working correctly.
There are two modes of operation.
1. Online Mode. Using a second comport and modem, Shop Master
will shell to Telepc-b.exe and process the order while the caller
waits.
2. Offline Mode. Shop Master will shell to Telepc-b.exe when the
user logs off the BBS. To use the offline function, run Order
Brain with the offline option.
SBRAIN NODE=2 OFFLINE
or
SBRAIN OFFLINE
etc.
If you use Shop Master in OFFLINE MODE with the Telepc Program,
you will need to modify the batch file that runs your BBS:
Sample GAP BBS Batch file (GAP.BAT) :
@ECHO OFF
GAPMENU
IF ERRORLEVEL 99 GOTO SHOP
GOTO END
:SHOP
SBRAIN OFFLINE
GAP
:END
Sample PCBoard Batch File (BOARD.BAT) :
@ECHO OFF
C:
CD \PCB
SET PCB=/SWAP
SET DSZLOG=C:\PCB\PCBDSZ.LOG
IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS
IF EXIST EVENT.BAT RENAME EVENT.BAT EVENT.SYS
IF EXIST DOOR.BAT DEL DOOR.BAT
IF EXIST ENDPCB DEL ENDPCB
PCB145
IF EXIST REMOTE.BAT REMOTE
IF EXIST DOOR.BAT DOOR
IF EXIST EVENT.BAT EVENT
IF EXIST ENDPCB GOTO END
SBRAIN OFFLINE
BOARD
:END
EXIT
The above modifications are only required when using The Shopping Door
in OFFLINE mode.
=======================================================================
The following sysop functions are available while awaiting
keyboard input :
F5 - Shell to DOS.
F8 - Twit user and return to BBS.
F10 - Initiate chat with user.
CF10 - Answer user page bell.
Home - Main user stats.
End - Displays sysop keys available.
PgDn - Secondary user stats.
Up Arrow - Increase user's time remaining by 5 minutes.
Dn Arrow - Decrease user's time remaining by 5 minutes.
One of the nicer features about using the TWIT key, is the user
is not told that "the sysop wants them to return to the BBS".
Instead, a very plain and simple message of "returning you to the
BBS" is displayed. This way, the user is given no indication
that the sysop is hovering about.
When using the F5 shell to DOS key, to return to the door
program, simply type EXIT at the DOS command prompt. It is not
necessary to change directories back to the door directory.
The Shop Master is smart enough to know which drive and directory the
door program is in and will reset the defaults upon return from
DOS.
The Up and Down Arrow keys increase and decrease the user's time
respectively by 5 minutes for each press of the key. There is no
indication of what is occurring (except by the fact the user's
time remaining will change), so the sysop should try not to have
a lead finger. The increase or decrease is effective only while
the user is in The Shop Master.
-- -- --
This version of The Shop Master is a DEMO.
No orders will be processed or written to file.
It will become full featured upon registration. This door is released
"As Is" and there is *NO* warranty or guarantee that it will work for
you and not cause any problems. You have chosen to use this door, YOU
are responsible for any unfortunate problems that may develop from its
use or misuse. I will gladly listen to any suggestions or problems you
may have, and I will do my best to fix whatever needs to be fixed.
I can not be held responsible for any problems you may have, whether
directly or indirectly due to the use of the door.
Please read REGISTER.DOC for information on how you can register
your copy of The Shop Master.
For complete support, contact me on The Brainex System.
Your questions will be quickly and cheerfully answered!
Have Fun!
Stanley Sheff
The Brainex System
310-275-2344 HST
310-273-5234 V.32bis
Voice Support for Registered Sysops!